General

This is an initial implementation for the OpenTracing bridge for the Python OpenTelemetry library. There are still some things I would like to handle before considering a merge. On the other hand this is a big PR and I would like to start getting feedback as soon as possible, so I'm opening a draft PR while I work on closing the remaining work items (see TODO section below).

This PR supersedes #120. I have found it easier to open a new PR rather than altering the old one due to a significantly different implementation. Please tell me if I should edit the original PR instead.

Implementation

The PR adds an OpenTracing "shim". The shim is a collection of wrapper classes which should allow an OpenTracing user to instantiate an OpenTelemetry tracer and use it as if it were an OpenTracing tracer, without altering instrumentation code.

TODO

The following should probably be done before merging:

• Squash commits. The current commits aren't properly organized so we should rebase and/or squash them before merging. I'm not sure how granular the commits should be - one big commit for the entire feature? A couple of smaller commits which are divided logically?
• Add documentation. I want to ensure all the new classes and functions have Sphinx-friendly docstrings. Additionally, we should generate the required Sphinx files to have proper docs for the bridge.
• Add typing. Following my conversation with @c24t, it could be nice to have typing info at least for the bridge's public API. This may require writing a typing stub for OpenTracing since the library doesn't currently include typing information.

The following features haven't been implemented yet:

• Inject/extract methods. I haven't got to implementing them yet but there is no blocker for doing so AFAICT.
• Baggage items. The spec doesn't specify baggage support yet, which is probably a blocker.

Testing

To run the unit tests, execute tox. Following are full instructions for running the tests from scratch, in case somebody finds it useful:

git clone git@github.com:kinvolk/opentelemetry-python.git
cd opentelemetry-python
git checkout johananl/ot-shim
virtualenv /tmp/venv
source /tmp/venv/bin/activate
pip install tox
tox

To use the bridge for tracing a dummy app, use the following:

git clone git@github.com:kinvolk/opentelemetry-python.git
cd opentelemetry-python
git checkout johananl/ot-shim
virtualenv /tmp/venv
source /tmp/venv/bin/activate
pip install ext/opentelemetry-ext-opentracing-shim
# An OpenTelemetry tracer is necessary. I've used the SDK here but a different tracer should also work.
pip install opentelemetry-sdk

Then, instrument an app:

import time
from opentelemetry.sdk.trace import Tracer, export
from opentelemetry.sdk.trace.export.in_memory_span_exporter import InMemorySpanExporter
from opentelemetry.ext.opentracing_shim import create_tracer

otel_tracer = Tracer()
memory_exporter = InMemorySpanExporter()
span_processor = export.SimpleExportSpanProcessor(memory_exporter)
otel_tracer.add_span_processor(span_processor)

tracer = create_tracer(otel_tracer)

print('------------Started------------')

with tracer.start_active_span('parent') as parent:
    time.sleep(0.1)
    with tracer.start_active_span('child') as child:
        time.sleep(0.3)

for s in memory_exporter.get_finished_spans():
    print(s)
    print(s.get_context())

print('-------------Done--------------')